home *** CD-ROM | disk | FTP | other *** search
/ Ahoy 1987 May / Ahoy_Magazine_87-05_1987_Double_L_Side_B.d64 / read and run.txt < prev    next >
Text File  |  2022-10-26  |  4KB  |  129 lines
  1. READ and RUN System 
  2.  
  3. by David Stidolph and Colin Thompson 
  4.  
  5. The idea of the Read and Run System
  6. is rather simple. Programs and their
  7. articles share space on a disk,
  8. eliminating the need for separate
  9. written documentation. One special
  10. file contains the names of the text
  11. files to read and programs to run.
  12. This file, names.dat, also contains
  13. other information explained below: 
  14.  
  15. +---------------------------------+
  16. !0.                               !
  17. !0.                               !
  18. !13.                              !
  19. !1.                               !
  20. !14.                              !
  21. !Read and Run Disk.               !
  22. !June.                            !
  23. !Read Run Disk for June.          !
  24. !Read Me.                         !
  25. !*end*.                           !
  26. !Run Me.                          !
  27. +---------------------------------!
  28.      actual word processor screen 
  29.  
  30. +---------------------------------+
  31. !0. <--background color           !
  32. !0. <--border color               !
  33. !13. <--text color for prompts    !
  34. !1. <--color to use for menu      !
  35. !14. <--highlighting color        !
  36. !Read and Run Disk. <--disk name  !
  37. !June. <--month                   !
  38. !Read Run Disk for June. <--header!
  39. !Read Me. <--article name         !
  40. !         <--more article names   !
  41. !         <--can go here          !
  42. !*end*. <--put after last article !
  43. !Run Me. <--program name          !
  44. !        <--more program names can!
  45. !        <--go here               !
  46. +---------------------------------+
  47.         same screen with comments 
  48.  
  49. The Read and Run menu program learns
  50. what text files and programs are on
  51. the disk by reading the file
  52. "names.dat". This file contains the
  53. necessary file names, plus
  54. information for the screen colors,
  55. and header information such as the
  56. date the disk was created. One
  57. example of its format is shown above.
  58.  
  59. The article and program titles (from
  60. the end of the "names.dat" file) are
  61. used as filenames as well as menu
  62. choices. Program file names are
  63. identical to the titles, but the
  64. suffix ".txt" is tacked onto the
  65. article title to become the filename
  66. (all upper case letters are also
  67. converted to lower case). For
  68. instance, the article "Read Me"
  69. matches the file "read me.txt". 
  70.  
  71. The main menu gives you the choice of
  72. reading articles, running programs,
  73. or printing all the articles complete
  74. with a table of contents. You may
  75. also exit the program into COMAL. 
  76.  
  77. The article text files should be
  78. Commodore ASCII SEQ files. Each line
  79. of text is limited to 37 characters
  80. and must end with a carriage return.
  81. The file is printe^ in one column on
  82. the screen, or in two columns on the
  83. printer. Note: some wor^ processors
  84. allow you to set margins and insert
  85. control codes into the text, but then
  86. give an option to print the file to
  87. disk as it would appear on the
  88. printer. This file would have the
  89. correct margins and carriage returns,
  90. but none of the control codes. If
  91. your word processor has this option,
  92. it is the one you should use to
  93. create your Read and Run files.
  94.  
  95. To produce your own Read and Run
  96. disk, you first need to format the
  97. disk with the title and id you want
  98. to use. Copy the COMAL 0.14 system
  99. onto this disk (use the top 9 files
  100. from the 0.14 side of Today Disk
  101. #16). Then gather your programs and
  102. articles. Note, your programs must be
  103. COMAL 0.14 programs; you can't run a
  104. BASIC program from a COMAL menu. The
  105. articles must follow the above
  106. conventions such as the 37 character
  107. per line limit. File names must be
  108. entirely in lower case and end with
  109. ".txt". Those who plan to donate a
  110. Read and Run disk of their own
  111. creation to a users group should be
  112. aware that not everyone is familiar
  113. with COMAL. It is not necessary to
  114. know COMAL to use the Read and Run
  115. system. COMAL is included on the
  116. disk. All the user needs to do is
  117. follow the menus. The files "comal
  118. article" and "info.txt" describe
  119. COMAL to beginners. They are part of
  120. the 9 system files you copied to your
  121. disk. 
  122.  
  123. Your disk is ready, except for the
  124. names.dat file. You should type this
  125. in a word processor and save it as a
  126. normal SEQ type text file (CTRL/-Z in
  127. PaperClip, or f1-f using Easy
  128. Script).
  129.